home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xm / XmTabListRemoveTabs.z / XmTabListRemoveTabs
Encoding:
Text File  |  2001-04-17  |  3.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeemmmmoooovvvveeeeTTTTaaaabbbbssss((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeemmmmoooovvvveeeeTTTTaaaabbbbssss((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeemmmmoooovvvveeeeTTTTaaaabbbbssss - A convenience function that removes
  10.           noncontiguous tabs
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeemmmmoooovvvveeeeTTTTaaaabbbbssss(
  15.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt oooollllddddlllliiiisssstttt,
  16.           CCCCaaaarrrrddddiiiinnnnaaaallll ****ppppoooossssiiiittttiiiioooonnnn____lllliiiisssstttt,
  17.           CCCCaaaarrrrddddiiiinnnnaaaallll ppppoooossssiiiittttiiiioooonnnn____ccccoooouuuunnnntttt);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeemmmmoooovvvveeeeTTTTaaaabbbbssss removes noncontiguous tabs from a tab
  24.           list.  The function creates a new tab list by copying the
  25.           contents of _o_l_d_l_i_s_t and removing all tabs whose
  26.           corresponding positions appear in the _p_o_s_i_t_i_o_n__l_i_s_t array.
  27.           A warning message is displayed if a specified position is
  28.           invalid; for example, if the value is a number greater than
  29.           the number of tabs in the tab list.
  30.  
  31.           _t_a_b_l_i_s_t   Specifies the tab list.  The function deallocates
  32.                     _o_l_d_l_i_s_t and the tabs it contains after extracting
  33.                     the required information.
  34.  
  35.           _p_o_s_i_t_i_o_n__l_i_s_t
  36.                     Specifies an array of the tab positions to be
  37.                     removed. The position of the first tab in the list
  38.                     is 0 (zero), the position of the second tab is 1,
  39.                     and so on.
  40.  
  41.           _p_o_s_i_t_i_o_n__c_o_u_n_t
  42.                     Specifies the number of elements in the
  43.                     _p_o_s_i_t_i_o_n__l_i_s_t.
  44.  
  45.      RRRREEEETTTTUUUURRRRNNNN
  46.           If _o_l_d_l_i_s_t or _p_o_s_i_t_i_o_n__l_i_s_t is NULL, or _p_o_s_i_t_i_o_n__c_o_u_n_t is 0
  47.           (zero), returns _o_l_d_l_i_s_t. Otherwise, this function returns
  48.           the new tab list.  The function allocates space to hold the
  49.           returned tab list.  The application is responsible for
  50.           managing the allocated space.  The application can recover
  51.           the allocated space by calling XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttFFFFrrrreeeeeeee.
  52.  
  53.      RRRREEEELLLLAAAATTTTEEEEDDDD
  54.           XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt(3) and XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttFFFFrrrreeeeeeee(3).
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 4/6/01)
  64.  
  65.  
  66.  
  67.